Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Creating Tracks and Media Structures

DisposeMovieTrack

The DisposeMovieTrack function removes a track from a movie.

pascal void DisposeMovieTrack (Track theTrack);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

DESCRIPTION

When you remove a track from a movie, the Movie Toolbox also removes the corresponding media from the movie.

SPECIAL CONSIDERATIONS

Your application should not call this function as part of the process of disposing of a movie. When you dispose of a movie by calling the DisposeMovie function (described on page 2-83), the Movie Toolbox disposes of all the movie's tracks and their associated media structures.

ERROR CODES

invalidTrack	-2009	This track is corrupted or invalid
trackNotInMovie	-2030	This track is not in this movie